--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
lang/README.it.md v4.3.1 (35884c15) Text, 7.35 KB
Reticulum MeshChatX
Un fork ampiamente modificato e ricco di funzionalita di Reticulum MeshChat di Liam Cottle.
Questo progetto e indipendente dal progetto originale Reticulum MeshChat e non e affiliato ad esso.
• Codice sorgente: git.quad4.io/RNS-Things/MeshChatX
• Release: git.quad4.io/RNS-Things/MeshChatX/releases
• Changelog: CHANGELOG.md
• TODO: TODO.md
Note importanti
• Il supporto completo LXMF e un obiettivo centrale del progetto.
• L'archiviazione e le migrazioni sono state progressivamente rielaborate verso SQL diretto (sostituendo i percorsi legacy Peewee ORM).
│ [!WARNING] MeshChatX non garantisce la compatibilita dei dati con le versioni precedenti di
│ Reticulum MeshChat. Eseguire un backup prima della migrazione o dei test.
│ [!WARNING] I sistemi legacy non sono ancora completamente supportati. Requisiti minimi attuali:
│ Python T383838>=3.11 e Node T383838>=24.
Demo e screenshot
<video src="https://strg.0rbitzer0.net/raw/62926a2a-0a9a-4f44-a5f6-000dd60deac1.mp4" controls="controls" style="max-width: 100%;"></video>
Interfaccia
Requisiti
• Python T383838>=3.11 (da T383838pyproject.toml)
• Node.js T383838>=24 (da T383838package.json)
• pnpm T38383810.30.0 (da T383838package.json)
• Poetry (utilizzato in T383838Taskfile.yml e nei workflow CI)
Nix (flake.nix)
Il repository include un Nix flake in T383838flake.nix.
Entrare nella dev shell
T282828
nix develop
Compilare il pacchetto Nix predefinito
T282828
nix build .#default
Flusso di lavoro tipico dentro T383838nix develop
T282828
task install
task lint:all
task test:all
task build:all
Metodi di installazione
┌─────────────────────────┬──────────────────────┬───────────────────────────────────────────┬─────┐
│ Metodo │ Include frontend │ Architetture │ Id… │
├─────────────────────────┼──────────────────────┼───────────────────────────────────────────┼─────┤
│ Immagine Docker │ Si │ T383838linux/amd64, T383838linux/arm64 │ Av… │
│ Python wheel (T383838.whl) │ Si │ Qualsiasi architettura supportata da Pyt… │ In… │
│ Linux AppImage │ Si │ T383838x64, T383838arm64 │ Us… │
│ Pacchetto Debian (T383838.deb) │ Si │ T383838x64, T383838arm64 │ In… │
│ Pacchetto RPM (T383838.rpm) │ Si │ Dipende dal CI │ Fe… │
│ Da sorgente │ Compilato localmente │ Architettura host │ Sv… │
└─────────────────────────┴──────────────────────┴───────────────────────────────────────────┴─────┘
Note:
• Il workflow di release compila esplicitamente Linux T383838x64 e T383838arm64 AppImage + DEB.
• RPM viene anche tentato e caricato quando prodotto con successo.
Avvio rapido: Docker
T282828
docker compose up -d
Il file compose predefinito mappa:
• T383838127.0.0.1:8000 sull'host -> porta T3838388000 del container
• T383838./meshchat-config -> T383838/config per la persistenza
In caso di errori di permessi:
T282828
sudo chown -R T79c0ff1000:1000 ./meshchat-config
Installazione da artefatti di release
1) Linux AppImage (x64/arm64)
1. Scaricare T383838ReticulumMeshChatX-v<versione>-linux-<arch>.AppImage dalle release.
2. Rendere eseguibile e avviare:
T282828
chmod +x ./ReticulumMeshChatX-v*-linux-*.AppImage
./ReticulumMeshChatX-v*-linux-*.AppImage
2) Debian/Ubuntu T383838.deb (x64/arm64)
1. Scaricare T383838ReticulumMeshChatX-v<versione>-linux-<arch>.deb.
2. Installare:
T282828
sudo apt install ./ReticulumMeshChatX-v*-linux-*.deb
3) Sistemi RPM
1. Scaricare T383838ReticulumMeshChatX-v<versione>-linux-<arch>.rpm se presente nella release.
2. Installare:
T282828
sudo rpm -Uvh ./ReticulumMeshChatX-v*-linux-*.rpm
4) Python wheel (T383838.whl)
I wheel delle release includono gli asset web compilati.
T282828
pip install ./reticulum_meshchatx-*-py3-none-any.whl
meshchat --headless
T383838pipx e supportato:
T282828
pipx install ./reticulum_meshchatx-*-py3-none-any.whl
Esecuzione da sorgente (modalita web server)
T282828
git clone https://git.quad4.io/RNS-Things/MeshChatX.git
Tffa657cd MeshChatX
corepack Tffa657enable
pnpm install
pip install poetry
poetry install
pnpm run build-frontend
poetry run meshchat --headless --host T79c0ff127.0.0.1
Compilazione pacchetti desktop da sorgente
Linux x64 AppImage + DEB
T282828
pnpm run dist:linux-x64
Linux arm64 AppImage + DEB
T282828
pnpm run dist:linux-arm64
RPM
T282828
pnpm run dist:rpm
Supporto architetture
• Docker: T383838amd64, T383838arm64
• Linux AppImage: T383838x64, T383838arm64
• Linux DEB: T383838x64, T383838arm64
• Windows: T383838x64, T383838arm64 (script di build disponibili)
• macOS: script di build disponibili (T383838arm64, T383838universal)
• Android: progetto e workflow CI presenti nel repository
Android
Configurazione
┌───────────────┬──────────────────────┬─────────────┬───────────────────────────────────────┐
│ Argomento │ Variabile d'ambiente │ Predefinito │ Descrizione │
├───────────────┼──────────────────────┼─────────────┼───────────────────────────────────────┤
│ T383838--host │ T383838MESHCHAT_HOST │ T383838127.0.0.1 │ Indirizzo del web server │
│ T383838--port │ T383838MESHCHAT_PORT │ T3838388000 │ Porta del web server │
│ T383838--no-https │ T383838MESHCHAT_NO_HTTPS │ T383838false │ Disattiva HTTPS │
│ T383838--headless │ T383838MESHCHAT_HEADLESS │ T383838false │ Non aprire il browser automaticamente │
│ T383838--auth │ T383838MESHCHAT_AUTH │ T383838false │ Attiva autenticazione base │
│ T383838--storage-dir │ T383838MESHCHAT_STORAGE_DIR │ T383838./storage │ Directory dei dati │
│ T383838--public-dir │ T383838MESHCHAT_PUBLIC_DIR │ auto │ Directory dei file frontend │
└───────────────┴──────────────────────┴─────────────┴───────────────────────────────────────┘
Branch
┌────────┬───────────────────────────────────────────────────────────────────────┐
│ Branch │ Scopo │
├────────┼───────────────────────────────────────────────────────────────────────┤
│ T383838master │ Release stabili. Solo codice pronto per la produzione. │
│ T383838dev │ Sviluppo attivo. Potrebbe contenere modifiche instabili o incomplete. │
└────────┴───────────────────────────────────────────────────────────────────────┘
Sviluppo
T282828
task install
task lint:all
task test:all
task build:all
Sicurezza
• Controlli di integrita integrati e HTTPS/WSS predefiniti
• Workflow di scansione CI in T383838.gitea/workflows/
Crediti
• Liam Cottle - Reticulum MeshChat originale
• RFnexus - Parser Micron JavaScript
• markqvist - Reticulum, LXMF, LXST
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────